home *** CD-ROM | disk | FTP | other *** search
/ Personal Computer World 2005 October / PCWOCT05.iso / Software / FromTheMag / XAMPP 1.4.14 / xampp-win32-1.4.14-installer.exe / xampp / php / pear / adodb / drivers / adodb-oci8.inc.php < prev    next >
PHP Script  |  2005-05-17  |  43KB  |  1,442 lines
  1. <?php
  2. /*
  3.  
  4.   version V4.63 17 May 2005 (c) 2000-2005 John Lim. All rights reserved.
  5.  
  6.   Released under both BSD license and Lesser GPL library license. 
  7.   Whenever there is any discrepancy between the two licenses, 
  8.   the BSD license will take precedence.
  9.  
  10.   Latest version is available at http://adodb.sourceforge.net
  11.   
  12.   Code contributed by George Fourlanos <fou@infomap.gr>
  13.   
  14.   13 Nov 2000 jlim - removed all ora_* references.
  15. */
  16.  
  17. // security - hide paths
  18. if (!defined('ADODB_DIR')) die();
  19.  
  20. /*
  21. NLS_Date_Format
  22. Allows you to use a date format other than the Oracle Lite default. When a literal
  23. character string appears where a date value is expected, the Oracle Lite database
  24. tests the string to see if it matches the formats of Oracle, SQL-92, or the value
  25. specified for this parameter in the POLITE.INI file. Setting this parameter also
  26. defines the default format used in the TO_CHAR or TO_DATE functions when no
  27. other format string is supplied.
  28.  
  29. For Oracle the default is dd-mon-yy or dd-mon-yyyy, and for SQL-92 the default is
  30. yy-mm-dd or yyyy-mm-dd.
  31.  
  32. Using 'RR' in the format forces two-digit years less than or equal to 49 to be
  33. interpreted as years in the 21st century (2000û2049), and years over 50 as years in
  34. the 20th century (1950û1999). Setting the RR format as the default for all two-digit
  35. year entries allows you to become year-2000 compliant. For example:
  36. NLS_DATE_FORMAT='RR-MM-DD'
  37.  
  38. You can also modify the date format using the ALTER SESSION command. 
  39. */
  40.  
  41. # define the LOB descriptor type for the given type
  42. # returns false if no LOB descriptor
  43. function oci_lob_desc($type) {
  44.     switch ($type) {
  45.         case OCI_B_BFILE: $result = OCI_D_FILE; break;
  46.         case OCI_B_CFILEE: $result = OCI_D_FILE; break;
  47.         case OCI_B_CLOB: $result = OCI_D_LOB; break;
  48.         case OCI_B_BLOB: $result = OCI_D_LOB; break;
  49.         case OCI_B_ROWID: $result = OCI_D_ROWID; break;
  50.         default: $result = false; break;
  51.     }
  52.     return $result;
  53. }
  54.  
  55. class ADODB_oci8 extends ADOConnection {
  56.     var $databaseType = 'oci8';
  57.     var $dataProvider = 'oci8';
  58.     var $replaceQuote = "''"; // string to use to replace quotes
  59.     var $concat_operator='||';
  60.     var $sysDate = "TRUNC(SYSDATE)";
  61.     var $sysTimeStamp = 'SYSDATE';
  62.     var $metaDatabasesSQL = "SELECT USERNAME FROM ALL_USERS WHERE USERNAME NOT IN ('SYS','SYSTEM','DBSNMP','OUTLN') ORDER BY 1";
  63.     var $_stmt;
  64.     var $_commit = OCI_COMMIT_ON_SUCCESS;
  65.     var $_initdate = true; // init date to YYYY-MM-DD
  66.     var $metaTablesSQL = "select table_name,table_type from cat where table_type in ('TABLE','VIEW')";
  67.     var $metaColumnsSQL = "select cname,coltype,width, SCALE, PRECISION, NULLS, DEFAULTVAL from col where tname='%s' order by colno"; //changed by smondino@users.sourceforge. net
  68.     var $_bindInputArray = true;
  69.     var $hasGenID = true;
  70.     var $_genIDSQL = "SELECT (%s.nextval) FROM DUAL";
  71.     var $_genSeqSQL = "CREATE SEQUENCE %s START WITH %s";
  72.     var $_dropSeqSQL = "DROP SEQUENCE %s";
  73.     var $hasAffectedRows = true;
  74.     var $random = "abs(mod(DBMS_RANDOM.RANDOM,10000001)/10000000)";
  75.     var $noNullStrings = false;
  76.     var $connectSID = false;
  77.     var $_bind = false;
  78.     var $_hasOCIFetchStatement = false;
  79.     var $_getarray = false; // currently not working
  80.     var $leftOuter = '';  // oracle wierdness, $col = $value (+) for LEFT OUTER, $col (+)= $value for RIGHT OUTER
  81.     var $session_sharing_force_blob = false; // alter session on updateblob if set to true 
  82.     var $firstrows = true; // enable first rows optimization on SelectLimit()
  83.     var $selectOffsetAlg1 = 100; // when to use 1st algorithm of selectlimit.
  84.     var $NLS_DATE_FORMAT = 'YYYY-MM-DD';  // To include time, use 'RRRR-MM-DD HH24:MI:SS'
  85.      var $useDBDateFormatForTextInput=false;
  86.     var $datetime = false; // MetaType('DATE') returns 'D' (datetime==false) or 'T' (datetime == true)
  87.     var $_refLOBs = array();
  88.     
  89.     // var $ansiOuter = true; // if oracle9
  90.     
  91.     function ADODB_oci8() 
  92.     {
  93.         $this->_hasOCIFetchStatement = ADODB_PHPVER >= 0x4200;
  94.         if (defined('ADODB_EXTENSION')) $this->rsPrefix .= 'ext_';
  95.     }
  96.     
  97.     /*  Function &MetaColumns($table) added by smondino@users.sourceforge.net*/
  98.     function &MetaColumns($table) 
  99.     {
  100.     global $ADODB_FETCH_MODE;
  101.     
  102.         $false = false;
  103.         $save = $ADODB_FETCH_MODE;
  104.         $ADODB_FETCH_MODE = ADODB_FETCH_NUM;
  105.         if ($this->fetchMode !== false) $savem = $this->SetFetchMode(false);
  106.         
  107.         $rs = $this->Execute(sprintf($this->metaColumnsSQL,strtoupper($table)));
  108.         
  109.         if (isset($savem)) $this->SetFetchMode($savem);
  110.         $ADODB_FETCH_MODE = $save;
  111.         if (!$rs) {
  112.             return $false;
  113.         }
  114.         $retarr = array();
  115.         while (!$rs->EOF) { //print_r($rs->fields);
  116.             $fld = new ADOFieldObject();
  117.                $fld->name = $rs->fields[0];
  118.                $fld->type = $rs->fields[1];
  119.                $fld->max_length = $rs->fields[2];
  120.             $fld->scale = $rs->fields[3];
  121.             if ($rs->fields[1] == 'NUMBER' && $rs->fields[3] == 0) {
  122.                 $fld->type ='INT';
  123.                  $fld->max_length = $rs->fields[4];
  124.             }    
  125.                $fld->not_null = (strncmp($rs->fields[5], 'NOT',3) === 0);
  126.             $fld->binary = (strpos($fld->type,'BLOB') !== false);
  127.             $fld->default_value = $rs->fields[6];
  128.             
  129.             if ($ADODB_FETCH_MODE == ADODB_FETCH_NUM) $retarr[] = $fld;    
  130.             else $retarr[strtoupper($fld->name)] = $fld;
  131.             $rs->MoveNext();
  132.         }
  133.         $rs->Close();
  134.         return (empty($retarr)) ? $false : $retarr;
  135.     }
  136.     
  137.     function Time()
  138.     {
  139.         $rs =& $this->Execute("select TO_CHAR($this->sysTimeStamp,'YYYY-MM-DD HH24:MI:SS') from dual");
  140.         if ($rs && !$rs->EOF) return $this->UnixTimeStamp(reset($rs->fields));
  141.         
  142.         return false;
  143.     }
  144.  
  145. /*
  146.  
  147.   Multiple modes of connection are supported:
  148.   
  149.   a. Local Database
  150.     $conn->Connect(false,'scott','tiger');
  151.   
  152.   b. From tnsnames.ora
  153.     $conn->Connect(false,'scott','tiger',$tnsname); 
  154.     $conn->Connect($tnsname,'scott','tiger'); 
  155.   
  156.   c. Server + service name
  157.     $conn->Connect($serveraddress,'scott,'tiger',$service_name);
  158.   
  159.   d. Server + SID
  160.       $conn->connectSID = true;
  161.     $conn->Connect($serveraddress,'scott,'tiger',$SID);
  162.  
  163.  
  164. Example TNSName:
  165. ---------------
  166. NATSOFT.DOMAIN =
  167.   (DESCRIPTION =
  168.     (ADDRESS_LIST =
  169.       (ADDRESS = (PROTOCOL = TCP)(HOST = kermit)(PORT = 1523))
  170.     )
  171.     (CONNECT_DATA =
  172.       (SERVICE_NAME = natsoft.domain)
  173.     )
  174.   )
  175.   
  176.   There are 3 connection modes, 0 = non-persistent, 1 = persistent, 2 = force new connection
  177.     
  178. */
  179.     function _connect($argHostname, $argUsername, $argPassword, $argDatabasename,$mode=0)
  180.     {
  181.         if (!function_exists('OCIPLogon')) return null;
  182.         
  183.         
  184.         $this->_errorMsg = false;
  185.         $this->_errorCode = false;
  186.         
  187.         if($argHostname) { // added by Jorma Tuomainen <jorma.tuomainen@ppoy.fi>
  188.             if (empty($argDatabasename)) $argDatabasename = $argHostname;
  189.             else {
  190.                 if(strpos($argHostname,":")) {
  191.                     $argHostinfo=explode(":",$argHostname);
  192.                        $argHostname=$argHostinfo[0];
  193.                     $argHostport=$argHostinfo[1];
  194.                  } else {
  195.                     $argHostport="1521";
  196.                    }
  197.                 
  198.                 if ($this->connectSID) {
  199.                     $argDatabasename="(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=".$argHostname
  200.                     .")(PORT=$argHostport))(CONNECT_DATA=(SID=$argDatabasename)))";
  201.                 } else
  202.                     $argDatabasename="(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=".$argHostname
  203.                     .")(PORT=$argHostport))(CONNECT_DATA=(SERVICE_NAME=$argDatabasename)))";
  204.             }
  205.         }
  206.                 
  207.          //if ($argHostname) print "<p>Connect: 1st argument should be left blank for $this->databaseType</p>";
  208.         if ($mode==1) {
  209.             $this->_connectionID = ($this->charSet) ? 
  210.                 OCIPLogon($argUsername,$argPassword, $argDatabasename)
  211.                 :
  212.                 OCIPLogon($argUsername,$argPassword, $argDatabasename, $this->charSet)
  213.                 ;
  214.             if ($this->_connectionID && $this->autoRollback)  OCIrollback($this->_connectionID);
  215.         } else if ($mode==2) {
  216.             $this->_connectionID = ($this->charSet) ? 
  217.                 OCINLogon($argUsername,$argPassword, $argDatabasename)
  218.                 :
  219.                 OCINLogon($argUsername,$argPassword, $argDatabasename, $this->charSet);
  220.                 
  221.         } else {
  222.             $this->_connectionID = ($this->charSet) ? 
  223.                 OCILogon($argUsername,$argPassword, $argDatabasename)
  224.                 :
  225.                 OCILogon($argUsername,$argPassword, $argDatabasename,$this->charSet);
  226.         }
  227.         if ($this->_connectionID === false) return false;
  228.         if ($this->_initdate) {
  229.             $this->Execute("ALTER SESSION SET NLS_DATE_FORMAT='".$this->NLS_DATE_FORMAT."'");
  230.         }
  231.         
  232.         // looks like: 
  233.         // Oracle8i Enterprise Edition Release 8.1.7.0.0 - Production With the Partitioning option JServer Release 8.1.7.0.0 - Production
  234.         // $vers = OCIServerVersion($this->_connectionID);
  235.         // if (strpos($vers,'8i') !== false) $this->ansiOuter = true;
  236.         return true;
  237.        }
  238.     
  239.     function ServerInfo()
  240.     {
  241.         $arr['compat'] = $this->GetOne('select value from sys.database_compatible_level');
  242.         $arr['description'] = @OCIServerVersion($this->_connectionID);
  243.         $arr['version'] = ADOConnection::_findvers($arr['description']);
  244.         return $arr;
  245.     }
  246.         // returns true or false
  247.     function _pconnect($argHostname, $argUsername, $argPassword, $argDatabasename)
  248.     {
  249.         return $this->_connect($argHostname, $argUsername, $argPassword, $argDatabasename,1);
  250.     }
  251.     
  252.     // returns true or false
  253.     function _nconnect($argHostname, $argUsername, $argPassword, $argDatabasename)
  254.     {
  255.         return $this->_connect($argHostname, $argUsername, $argPassword, $argDatabasename,2);
  256.     }
  257.     
  258.     function _affectedrows()
  259.     {
  260.         if (is_resource($this->_stmt)) return @OCIRowCount($this->_stmt);
  261.         return 0;
  262.     }
  263.     
  264.     function IfNull( $field, $ifNull ) 
  265.     {
  266.         return " NVL($field, $ifNull) "; // if Oracle
  267.     }
  268.     
  269.     // format and return date string in database date format
  270.     function DBDate($d)
  271.     {
  272.         if (empty($d) && $d !== 0) return 'null';
  273.         
  274.         if (is_string($d)) $d = ADORecordSet::UnixDate($d);
  275.         return "TO_DATE(".adodb_date($this->fmtDate,$d).",'".$this->NLS_DATE_FORMAT."')";
  276.     }
  277.  
  278.     
  279.     // format and return date string in database timestamp format
  280.     function DBTimeStamp($ts)
  281.     {
  282.         if (empty($ts) && $ts !== 0) return 'null';
  283.         if (is_string($ts)) $ts = ADORecordSet::UnixTimeStamp($ts);
  284.         return 'TO_DATE('.adodb_date($this->fmtTimeStamp,$ts).",'RRRR-MM-DD, HH:MI:SS AM')";
  285.     }
  286.     
  287.     function RowLock($tables,$where,$flds='1 as ignore') 
  288.     {
  289.         if ($this->autoCommit) $this->BeginTrans();
  290.         return $this->GetOne("select $flds from $tables where $where for update");
  291.     }
  292.     
  293.     function &MetaTables($ttype=false,$showSchema=false,$mask=false) 
  294.     {
  295.         if ($mask) {
  296.             $save = $this->metaTablesSQL;
  297.             $mask = $this->qstr(strtoupper($mask));
  298.             $this->metaTablesSQL .= " AND table_name like $mask";
  299.         }
  300.         $ret =& ADOConnection::MetaTables($ttype,$showSchema);
  301.         
  302.         if ($mask) {
  303.             $this->metaTablesSQL = $save;
  304.         }
  305.         return $ret;
  306.     }
  307.     
  308.     // Mark Newnham 
  309.     function &MetaIndexes ($table, $primary = FALSE, $owner=false)
  310.     {
  311.         // save old fetch mode
  312.         global $ADODB_FETCH_MODE;
  313.  
  314.         $save = $ADODB_FETCH_MODE;
  315.         $ADODB_FETCH_MODE = ADODB_FETCH_NUM;
  316.  
  317.         if ($this->fetchMode !== FALSE) {
  318.                $savem = $this->SetFetchMode(FALSE);
  319.         }
  320.  
  321.         // get index details
  322.         $table = strtoupper($table);
  323.  
  324.         // get Primary index
  325.         $primary_key = '';
  326.  
  327.         $false = false;
  328.         $rs = $this->Execute(sprintf("SELECT * FROM ALL_CONSTRAINTS WHERE UPPER(TABLE_NAME)='%s' AND CONSTRAINT_TYPE='P'",$table));
  329.         if ($row = $rs->FetchRow())
  330.            $primary_key = $row[1]; //constraint_name
  331.  
  332.         if ($primary==TRUE && $primary_key=='') {
  333.              if (isset($savem)) 
  334.                 $this->SetFetchMode($savem);
  335.             $ADODB_FETCH_MODE = $save;
  336.             return $false; //There is no primary key
  337.         }
  338.  
  339.         $rs = $this->Execute(sprintf("SELECT ALL_INDEXES.INDEX_NAME, ALL_INDEXES.UNIQUENESS, ALL_IND_COLUMNS.COLUMN_POSITION, ALL_IND_COLUMNS.COLUMN_NAME FROM ALL_INDEXES,ALL_IND_COLUMNS WHERE UPPER(ALL_INDEXES.TABLE_NAME)='%s' AND ALL_IND_COLUMNS.INDEX_NAME=ALL_INDEXES.INDEX_NAME",$table));
  340.  
  341.         
  342.         if (!is_object($rs)) {
  343.             if (isset($savem)) 
  344.                 $this->SetFetchMode($savem);
  345.             $ADODB_FETCH_MODE = $save;
  346.             return $false;
  347.         }
  348.  
  349.         $indexes = array ();
  350.         // parse index data into array
  351.  
  352.         while ($row = $rs->FetchRow()) {
  353.             if ($primary && $row[0] != $primary_key) continue;
  354.             if (!isset($indexes[$row[0]])) {
  355.                 $indexes[$row[0]] = array(
  356.                    'unique' => ($row[1] == 'UNIQUE'),
  357.                    'columns' => array()
  358.                 );
  359.             }
  360.             $indexes[$row[0]]['columns'][$row[2] - 1] = $row[3];
  361.         }
  362.  
  363.         // sort columns by order in the index
  364.         foreach ( array_keys ($indexes) as $index ) {
  365.             ksort ($indexes[$index]['columns']);
  366.         }
  367.  
  368.         if (isset($savem)) { 
  369.             $this->SetFetchMode($savem);
  370.             $ADODB_FETCH_MODE = $save;
  371.         }
  372.         return $indexes;
  373.     }
  374.     
  375.     function BeginTrans()
  376.     {    
  377.         if ($this->transOff) return true;
  378.         $this->transCnt += 1;
  379.         $this->autoCommit = false;
  380.         $this->_commit = OCI_DEFAULT;
  381.         return true;
  382.     }
  383.     
  384.     function CommitTrans($ok=true) 
  385.     { 
  386.         if ($this->transOff) return true;
  387.         if (!$ok) return $this->RollbackTrans();
  388.         
  389.         if ($this->transCnt) $this->transCnt -= 1;
  390.         $ret = OCIcommit($this->_connectionID);
  391.         $this->_commit = OCI_COMMIT_ON_SUCCESS;
  392.         $this->autoCommit = true;
  393.         return $ret;
  394.     }
  395.     
  396.     function RollbackTrans()
  397.     {
  398.         if ($this->transOff) return true;
  399.         if ($this->transCnt) $this->transCnt -= 1;
  400.         $ret = OCIrollback($this->_connectionID);
  401.         $this->_commit = OCI_COMMIT_ON_SUCCESS;
  402.         $this->autoCommit = true;
  403.         return $ret;
  404.     }
  405.     
  406.     
  407.     function SelectDB($dbName) 
  408.     {
  409.         return false;
  410.     }
  411.  
  412.     function ErrorMsg() 
  413.     {
  414.         if ($this->_errorMsg !== false) return $this->_errorMsg;
  415.  
  416.         if (is_resource($this->_stmt)) $arr = @OCIerror($this->_stmt);
  417.         if (empty($arr)) {
  418.             $arr = @OCIerror($this->_connectionID);
  419.             if ($arr === false) $arr = @OCIError();
  420.             if ($arr === false) return '';
  421.         }
  422.         $this->_errorMsg = $arr['message'];
  423.         $this->_errorCode = $arr['code'];
  424.         return $this->_errorMsg;
  425.     }
  426.  
  427.     function ErrorNo() 
  428.     {
  429.         if ($this->_errorCode !== false) return $this->_errorCode;
  430.         
  431.         if (is_resource($this->_stmt)) $arr = @OCIError($this->_stmt);
  432.         if (empty($arr)) {
  433.             $arr = @OCIError($this->_connectionID);
  434.             if ($arr == false) $arr = @OCIError();
  435.             if ($arr == false) return '';
  436.         }
  437.         
  438.         $this->_errorMsg = $arr['message'];
  439.         $this->_errorCode = $arr['code'];
  440.         
  441.         return $arr['code'];
  442.     }
  443.     
  444.     // Format date column in sql string given an input format that understands Y M D
  445.     function SQLDate($fmt, $col=false)
  446.     {    
  447.         if (!$col) $col = $this->sysTimeStamp;
  448.         $s = 'TO_CHAR('.$col.",'";
  449.         
  450.         $len = strlen($fmt);
  451.         for ($i=0; $i < $len; $i++) {
  452.             $ch = $fmt[$i];
  453.             switch($ch) {
  454.             case 'Y':
  455.             case 'y':
  456.                 $s .= 'YYYY';
  457.                 break;
  458.             case 'Q':
  459.             case 'q':
  460.                 $s .= 'Q';
  461.                 break;
  462.                 
  463.             case 'M':
  464.                 $s .= 'Mon';
  465.                 break;
  466.                 
  467.             case 'm':
  468.                 $s .= 'MM';
  469.                 break;
  470.             case 'D':
  471.             case 'd':
  472.                 $s .= 'DD';
  473.                 break;
  474.             
  475.             case 'H':
  476.                 $s.= 'HH24';
  477.                 break;
  478.                 
  479.             case 'h':
  480.                 $s .= 'HH';
  481.                 break;
  482.                 
  483.             case 'i':
  484.                 $s .= 'MI';
  485.                 break;
  486.             
  487.             case 's':
  488.                 $s .= 'SS';
  489.                 break;
  490.             
  491.             case 'a':
  492.             case 'A':
  493.                 $s .= 'AM';
  494.                 break;
  495.                 
  496.             case 'w':
  497.                 $s .= 'D';
  498.                 break;
  499.                 
  500.             case 'l':
  501.                 $s .= 'DAY';
  502.                 break;
  503.                 
  504.             default:
  505.             // handle escape characters...
  506.                 if ($ch == '\\') {
  507.                     $i++;
  508.                     $ch = substr($fmt,$i,1);
  509.                 }
  510.                 if (strpos('-/.:;, ',$ch) !== false) $s .= $ch;
  511.                 else $s .= '"'.$ch.'"';
  512.                 
  513.             }
  514.         }
  515.         return $s. "')";
  516.     }
  517.     
  518.     
  519.     /*
  520.     This algorithm makes use of
  521.     
  522.     a. FIRST_ROWS hint
  523.     The FIRST_ROWS hint explicitly chooses the approach to optimize response time, 
  524.     that is, minimum resource usage to return the first row. Results will be returned 
  525.     as soon as they are identified. 
  526.  
  527.     b. Uses rownum tricks to obtain only the required rows from a given offset.
  528.      As this uses complicated sql statements, we only use this if the $offset >= 100. 
  529.      This idea by Tomas V V Cox.
  530.      
  531.      This implementation does not appear to work with oracle 8.0.5 or earlier. Comment
  532.      out this function then, and the slower SelectLimit() in the base class will be used.
  533.     */
  534.     function &SelectLimit($sql,$nrows=-1,$offset=-1, $inputarr=false,$secs2cache=0)
  535.     {
  536.         // seems that oracle only supports 1 hint comment in 8i
  537.         if ($this->firstrows) {
  538.             if (strpos($sql,'/*+') !== false)
  539.                 $sql = str_replace('/*+ ','/*+FIRST_ROWS ',$sql);
  540.             else
  541.                 $sql = preg_replace('/^[ \t\n]*select/i','SELECT /*+FIRST_ROWS*/',$sql);
  542.         }
  543.         
  544.         if ($offset < $this->selectOffsetAlg1) {
  545.             if ($nrows > 0) {    
  546.                 if ($offset > 0) $nrows += $offset;
  547.                 //$inputarr['adodb_rownum'] = $nrows;
  548.                 if ($this->databaseType == 'oci8po') {
  549.                     $sql = "select * from (".$sql.") where rownum <= ?";
  550.                 } else {
  551.                     $sql = "select * from (".$sql.") where rownum <= :adodb_offset";
  552.                 } 
  553.                 $inputarr['adodb_offset'] = $nrows;
  554.                 $nrows = -1;
  555.             }
  556.             // note that $nrows = 0 still has to work ==> no rows returned
  557.  
  558.             $rs =& ADOConnection::SelectLimit($sql,$nrows,$offset,$inputarr,$secs2cache);
  559.             return $rs;
  560.             
  561.         } else {
  562.              // Algorithm by Tomas V V Cox, from PEAR DB oci8.php
  563.             
  564.              // Let Oracle return the name of the columns
  565.             $q_fields = "SELECT * FROM (".$sql.") WHERE NULL = NULL";
  566.              
  567.             $false = false;
  568.             if (! $stmt_arr = $this->Prepare($q_fields)) {
  569.                 return $false;
  570.             }
  571.             $stmt = $stmt_arr[1];
  572.              
  573.              if (is_array($inputarr)) {
  574.                  foreach($inputarr as $k => $v) {
  575.                     if (is_array($v)) {
  576.                         if (sizeof($v) == 2) // suggested by g.giunta@libero.
  577.                             OCIBindByName($stmt,":$k",$inputarr[$k][0],$v[1]);
  578.                         else
  579.                             OCIBindByName($stmt,":$k",$inputarr[$k][0],$v[1],$v[2]);
  580.                     } else {
  581.                         $len = -1;
  582.                         if ($v === ' ') $len = 1;
  583.                         if (isset($bindarr)) {    // is prepared sql, so no need to ocibindbyname again
  584.                             $bindarr[$k] = $v;
  585.                         } else {                 // dynamic sql, so rebind every time
  586.                             OCIBindByName($stmt,":$k",$inputarr[$k],$len);
  587.                         }
  588.                     }
  589.                 }
  590.             }
  591.             
  592.              if (!OCIExecute($stmt, OCI_DEFAULT)) {
  593.                  OCIFreeStatement($stmt); 
  594.                  return $false;
  595.              }
  596.              
  597.              $ncols = OCINumCols($stmt);
  598.              for ( $i = 1; $i <= $ncols; $i++ ) {
  599.                  $cols[] = '"'.OCIColumnName($stmt, $i).'"';
  600.              }
  601.              $result = false;
  602.             
  603.              OCIFreeStatement($stmt); 
  604.              $fields = implode(',', $cols);
  605.              $nrows += $offset;
  606.              $offset += 1; // in Oracle rownum starts at 1
  607.             
  608.             if ($this->databaseType == 'oci8po') {
  609.                      $sql = "SELECT $fields FROM".
  610.                       "(SELECT rownum as adodb_rownum, $fields FROM".
  611.                       " ($sql) WHERE rownum <= ?".
  612.                       ") WHERE adodb_rownum >= ?";
  613.                 } else {
  614.                      $sql = "SELECT $fields FROM".
  615.                       "(SELECT rownum as adodb_rownum, $fields FROM".
  616.                       " ($sql) WHERE rownum <= :adodb_nrows".
  617.                       ") WHERE adodb_rownum >= :adodb_offset";
  618.                 } 
  619.                 $inputarr['adodb_nrows'] = $nrows;
  620.                 $inputarr['adodb_offset'] = $offset;
  621.                 
  622.             if ($secs2cache>0) $rs =& $this->CacheExecute($secs2cache, $sql,$inputarr);
  623.             else $rs =& $this->Execute($sql,$inputarr);
  624.             return $rs;
  625.         }
  626.     
  627.     }
  628.     
  629.     /**
  630.     * Usage:
  631.     * Store BLOBs and CLOBs
  632.     *
  633.     * Example: to store $var in a blob
  634.     *
  635.     *    $conn->Execute('insert into TABLE (id,ablob) values(12,empty_blob())');
  636.     *    $conn->UpdateBlob('TABLE', 'ablob', $varHoldingBlob, 'ID=12', 'BLOB');
  637.     *    
  638.     *    $blobtype supports 'BLOB' and 'CLOB', but you need to change to 'empty_clob()'.
  639.     *
  640.     *  to get length of LOB:
  641.     *      select DBMS_LOB.GETLENGTH(ablob) from TABLE
  642.     *
  643.     * If you are using CURSOR_SHARING = force, it appears this will case a segfault
  644.     * under oracle 8.1.7.0. Run:
  645.     *     $db->Execute('ALTER SESSION SET CURSOR_SHARING=EXACT');
  646.     * before UpdateBlob() then...
  647.     */
  648.  
  649.     function UpdateBlob($table,$column,$val,$where,$blobtype='BLOB')
  650.     {
  651.         
  652.         //if (strlen($val) < 4000) return $this->Execute("UPDATE $table SET $column=:blob WHERE $where",array('blob'=>$val)) != false;
  653.         
  654.         switch(strtoupper($blobtype)) {
  655.         default: ADOConnection::outp("<b>UpdateBlob</b>: Unknown blobtype=$blobtype"); return false;
  656.         case 'BLOB': $type = OCI_B_BLOB; break;
  657.         case 'CLOB': $type = OCI_B_CLOB; break;
  658.         }
  659.         
  660.         if ($this->databaseType == 'oci8po') 
  661.             $sql = "UPDATE $table set $column=EMPTY_{$blobtype}() WHERE $where RETURNING $column INTO ?";
  662.         else 
  663.             $sql = "UPDATE $table set $column=EMPTY_{$blobtype}() WHERE $where RETURNING $column INTO :blob";
  664.         
  665.         $desc = OCINewDescriptor($this->_connectionID, OCI_D_LOB);
  666.         $arr['blob'] = array($desc,-1,$type);
  667.         if ($this->session_sharing_force_blob) $this->Execute('ALTER SESSION SET CURSOR_SHARING=EXACT');
  668.         $commit = $this->autoCommit;
  669.         if ($commit) $this->BeginTrans();
  670.         $rs = $this->Execute($sql,$arr);
  671.         if ($rez = !empty($rs)) $desc->save($val);
  672.         $desc->free();
  673.         if ($commit) $this->CommitTrans();
  674.         if ($this->session_sharing_force_blob) $this->Execute('ALTER SESSION SET CURSOR_SHARING=FORCE');
  675.         
  676.         if ($rez) $rs->Close();
  677.         return $rez;
  678.     }
  679.     
  680.     /**
  681.     * Usage:  store file pointed to by $var in a blob
  682.     */
  683.     function UpdateBlobFile($table,$column,$val,$where,$blobtype='BLOB')
  684.     {
  685.         switch(strtoupper($blobtype)) {
  686.         default: ADOConnection::outp( "<b>UpdateBlob</b>: Unknown blobtype=$blobtype"); return false;
  687.         case 'BLOB': $type = OCI_B_BLOB; break;
  688.         case 'CLOB': $type = OCI_B_CLOB; break;
  689.         }
  690.         
  691.         if ($this->databaseType == 'oci8po') 
  692.             $sql = "UPDATE $table set $column=EMPTY_{$blobtype}() WHERE $where RETURNING $column INTO ?";
  693.         else 
  694.             $sql = "UPDATE $table set $column=EMPTY_{$blobtype}() WHERE $where RETURNING $column INTO :blob";
  695.         
  696.         $desc = OCINewDescriptor($this->_connectionID, OCI_D_LOB);
  697.         $arr['blob'] = array($desc,-1,$type);
  698.         
  699.         $this->BeginTrans();
  700.         $rs = ADODB_oci8::Execute($sql,$arr);
  701.         if ($rez = !empty($rs)) $desc->savefile($val);
  702.         $desc->free();
  703.         $this->CommitTrans();
  704.         
  705.         if ($rez) $rs->Close();
  706.         return $rez;
  707.     }
  708.  
  709.         /**
  710.      * Execute SQL 
  711.      *
  712.      * @param sql        SQL statement to execute, or possibly an array holding prepared statement ($sql[0] will hold sql text)
  713.      * @param [inputarr]    holds the input data to bind to. Null elements will be set to null.
  714.      * @return         RecordSet or false
  715.      */
  716.     function &Execute($sql,$inputarr=false) 
  717.     {
  718.         if ($this->fnExecute) {
  719.             $fn = $this->fnExecute;
  720.             $ret =& $fn($this,$sql,$inputarr);
  721.             if (isset($ret)) return $ret;
  722.         }
  723.         if ($inputarr) {
  724.             #if (!is_array($inputarr)) $inputarr = array($inputarr);
  725.             
  726.             $element0 = reset($inputarr);
  727.             
  728.             # is_object check because oci8 descriptors can be passed in
  729.             if (is_array($element0) && !is_object(reset($element0))) {
  730.                 if (is_string($sql))
  731.                     $stmt = $this->Prepare($sql);
  732.                 else
  733.                     $stmt = $sql;
  734.                     
  735.                 foreach($inputarr as $arr) {
  736.                     $ret =& $this->_Execute($stmt,$arr);
  737.                     if (!$ret) return $ret;
  738.                 }
  739.             } else {
  740.                 $ret =& $this->_Execute($sql,$inputarr);
  741.             }
  742.             
  743.         } else {
  744.             $ret =& $this->_Execute($sql,false);
  745.         }
  746.  
  747.         return $ret;
  748.     }
  749.     
  750.     /*
  751.         Example of usage:
  752.         
  753.         $stmt = $this->Prepare('insert into emp (empno, ename) values (:empno, :ename)');
  754.     */
  755.     function Prepare($sql,$cursor=false)
  756.     {
  757.     static $BINDNUM = 0;
  758.     
  759.         $stmt = OCIParse($this->_connectionID,$sql);
  760.  
  761.         if (!$stmt) return false;
  762.  
  763.         $BINDNUM += 1;
  764.         
  765.         $sttype = @OCIStatementType($stmt);
  766.         if ($sttype == 'BEGIN' || $sttype == 'DECLARE') {
  767.             return array($sql,$stmt,0,$BINDNUM, ($cursor) ? OCINewCursor($this->_connectionID) : false);
  768.         }
  769.         return array($sql,$stmt,0,$BINDNUM);
  770.     }
  771.     
  772.     /*
  773.         Call an oracle stored procedure and returns a cursor variable as a recordset. 
  774.         Concept by Robert Tuttle robert@ud.com
  775.         
  776.         Example:
  777.             Note: we return a cursor variable in :RS2
  778.             $rs = $db->ExecuteCursor("BEGIN adodb.open_tab(:RS2); END;",'RS2');
  779.             
  780.             $rs = $db->ExecuteCursor(
  781.                 "BEGIN :RS2 = adodb.getdata(:VAR1); END;", 
  782.                 'RS2',
  783.                 array('VAR1' => 'Mr Bean'));
  784.             
  785.     */
  786.     function &ExecuteCursor($sql,$cursorName='rs',$params=false)
  787.     {
  788.         if (is_array($sql)) $stmt = $sql;
  789.         else $stmt = ADODB_oci8::Prepare($sql,true); # true to allocate OCINewCursor
  790.     
  791.         if (is_array($stmt) && sizeof($stmt) >= 5) {
  792.             $hasref = true;
  793.             $this->Parameter($stmt, $ignoreCur, $cursorName, false, -1, OCI_B_CURSOR);
  794.             if ($params) {
  795.                 foreach($params as $k => $v) {
  796.                     $this->Parameter($stmt,$params[$k], $k);
  797.                 }
  798.             }
  799.         } else
  800.             $hasref = false;
  801.             
  802.         $rs =& $this->Execute($stmt);
  803.         if ($rs->databaseType == 'array') OCIFreeCursor($stmt[4]);
  804.         else if ($hasref) $rs->_refcursor = $stmt[4];
  805.         return $rs;
  806.     }
  807.     
  808.     /*
  809.         Bind a variable -- very, very fast for executing repeated statements in oracle. 
  810.         Better than using
  811.             for ($i = 0; $i < $max; $i++) {    
  812.                 $p1 = ?; $p2 = ?; $p3 = ?;
  813.                 $this->Execute("insert into table (col0, col1, col2) values (:0, :1, :2)", 
  814.                     array($p1,$p2,$p3));
  815.             }
  816.         
  817.         Usage:
  818.             $stmt = $DB->Prepare("insert into table (col0, col1, col2) values (:0, :1, :2)");
  819.             $DB->Bind($stmt, $p1);
  820.             $DB->Bind($stmt, $p2);
  821.             $DB->Bind($stmt, $p3);
  822.             for ($i = 0; $i < $max; $i++) {    
  823.                 $p1 = ?; $p2 = ?; $p3 = ?;
  824.                 $DB->Execute($stmt);
  825.             }
  826.             
  827.         Some timings:        
  828.             ** Test table has 3 cols, and 1 index. Test to insert 1000 records
  829.             Time 0.6081s (1644.60 inserts/sec) with direct OCIParse/OCIExecute
  830.             Time 0.6341s (1577.16 inserts/sec) with ADOdb Prepare/Bind/Execute
  831.             Time 1.5533s ( 643.77 inserts/sec) with pure SQL using Execute
  832.             
  833.         Now if PHP only had batch/bulk updating like Java or PL/SQL...
  834.     
  835.         Note that the order of parameters differs from OCIBindByName,
  836.         because we default the names to :0, :1, :2
  837.     */
  838.     function Bind(&$stmt,&$var,$size=4000,$type=false,$name=false,$isOutput=false)
  839.     {
  840.         
  841.         if (!is_array($stmt)) return false;
  842.         
  843.         if (($type == OCI_B_CURSOR) && sizeof($stmt) >= 5) { 
  844.             return OCIBindByName($stmt[1],":".$name,$stmt[4],$size,$type);
  845.         }
  846.         
  847.         if ($name == false) {
  848.             if ($type !== false) $rez = OCIBindByName($stmt[1],":".$stmt[2],$var,$size,$type);
  849.             else $rez = OCIBindByName($stmt[1],":".$stmt[2],$var,$size); // +1 byte for null terminator
  850.             $stmt[2] += 1;
  851.         } else if (oci_lob_desc($type)) {
  852.             if ($this->debug) {
  853.                 ADOConnection::outp("<b>Bind</b>: name = $name");
  854.             }
  855.             //we have to create a new Descriptor here
  856.             $numlob = count($this->_refLOBs);
  857.             $this->_refLOBs[$numlob]['LOB'] = OCINewDescriptor($this->_connectionID, oci_lob_desc($type));
  858.             $this->_refLOBs[$numlob]['TYPE'] = $isOutput;
  859.             
  860.             $tmp = &$this->_refLOBs[$numlob]['LOB'];
  861.             $rez = OCIBindByName($stmt[1], ":".$name, $tmp, -1, $type);
  862.             if ($this->debug) {
  863.                 ADOConnection::outp("<b>Bind</b>: descriptor has been allocated, var (".$name.") binded");
  864.             }
  865.             
  866.             // if type is input then write data to lob now
  867.             if ($isOutput == false) {
  868.                 $var = $this->BlobEncode($var);
  869.                 $tmp->WriteTemporary($var);
  870.                 $this->_refLOBs[$numlob]['VAR'] = &$var;
  871.                 if ($this->debug) {
  872.                     ADOConnection::outp("<b>Bind</b>: LOB has been written to temp");
  873.                 }
  874.             } else {
  875.                 $this->_refLOBs[$numlob]['VAR'] = &$var;
  876.             }
  877.             $rez = $tmp;
  878.         } else {
  879.             if ($this->debug) 
  880.                 ADOConnection::outp("<b>Bind</b>: name = $name");
  881.             
  882.             if ($type !== false) $rez = OCIBindByName($stmt[1],":".$name,$var,$size,$type);
  883.             else $rez = OCIBindByName($stmt[1],":".$name,$var,$size); // +1 byte for null terminator
  884.         }
  885.         
  886.         return $rez;
  887.     }
  888.     
  889.     function Param($name,$type=false)
  890.     {
  891.         return ':'.$name;
  892.     }
  893.     
  894.     /* 
  895.     Usage:
  896.         $stmt = $db->Prepare('select * from table where id =:myid and group=:group');
  897.         $db->Parameter($stmt,$id,'myid');
  898.         $db->Parameter($stmt,$group,'group');
  899.         $db->Execute($stmt);
  900.         
  901.         @param $stmt Statement returned by Prepare() or PrepareSP().
  902.         @param $var PHP variable to bind to
  903.         @param $name Name of stored procedure variable name to bind to.
  904.         @param [$isOutput] Indicates direction of parameter 0/false=IN  1=OUT  2= IN/OUT. This is ignored in oci8.
  905.         @param [$maxLen] Holds an maximum length of the variable.
  906.         @param [$type] The data type of $var. Legal values depend on driver.
  907.         
  908.         See OCIBindByName documentation at php.net.
  909.     */
  910.     function Parameter(&$stmt,&$var,$name,$isOutput=false,$maxLen=4000,$type=false)
  911.     {
  912.             if  ($this->debug) {
  913.                 $prefix = ($isOutput) ? 'Out' : 'In';
  914.                 $ztype = (empty($type)) ? 'false' : $type;
  915.                 ADOConnection::outp( "{$prefix}Parameter(\$stmt, \$php_var='$var', \$name='$name', \$maxLen=$maxLen, \$type=$ztype);");
  916.             }
  917.             return $this->Bind($stmt,$var,$maxLen,$type,$name,$isOutput);
  918.     }
  919.     
  920.     /*
  921.     returns query ID if successful, otherwise false
  922.     this version supports:
  923.     
  924.        1. $db->execute('select * from table');
  925.        
  926.        2. $db->prepare('insert into table (a,b,c) values (:0,:1,:2)');
  927.           $db->execute($prepared_statement, array(1,2,3));
  928.           
  929.        3. $db->execute('insert into table (a,b,c) values (:a,:b,:c)',array('a'=>1,'b'=>2,'c'=>3));
  930.        
  931.        4. $db->prepare('insert into table (a,b,c) values (:0,:1,:2)');
  932.           $db->bind($stmt,1); $db->bind($stmt,2); $db->bind($stmt,3); 
  933.           $db->execute($stmt);
  934.     */ 
  935.     function _query($sql,$inputarr)
  936.     {
  937.         
  938.         if (is_array($sql)) { // is prepared sql
  939.             $stmt = $sql[1];
  940.             
  941.             // we try to bind to permanent array, so that OCIBindByName is persistent
  942.             // and carried out once only - note that max array element size is 4000 chars
  943.             if (is_array($inputarr)) {
  944.                 $bindpos = $sql[3];
  945.                 if (isset($this->_bind[$bindpos])) {
  946.                 // all tied up already
  947.                     $bindarr = &$this->_bind[$bindpos];
  948.                 } else {
  949.                 // one statement to bind them all
  950.                     $bindarr = array();
  951.                     foreach($inputarr as $k => $v) {
  952.                         $bindarr[$k] = $v;
  953.                         OCIBindByName($stmt,":$k",$bindarr[$k],is_string($v) && strlen($v)>4000 ? -1 : 4000);
  954.                     }
  955.                     $this->_bind[$bindpos] = &$bindarr;
  956.                 }
  957.             }
  958.         } else {
  959.             $stmt=OCIParse($this->_connectionID,$sql);
  960.         }
  961.             
  962.         $this->_stmt = $stmt;
  963.         if (!$stmt) return false;
  964.     
  965.         if (defined('ADODB_PREFETCH_ROWS')) @OCISetPrefetch($stmt,ADODB_PREFETCH_ROWS);
  966.             
  967.         if (is_array($inputarr)) {
  968.             foreach($inputarr as $k => $v) {
  969.                 if (is_array($v)) {
  970.                     if (sizeof($v) == 2) // suggested by g.giunta@libero.
  971.                         OCIBindByName($stmt,":$k",$inputarr[$k][0],$v[1]);
  972.                     else
  973.                         OCIBindByName($stmt,":$k",$inputarr[$k][0],$v[1],$v[2]);
  974.                     
  975.                     if ($this->debug==99) echo "name=:$k",' var='.$inputarr[$k][0],' len='.$v[1],' type='.$v[2],'<br>';
  976.                 } else {
  977.                     $len = -1;
  978.                     if ($v === ' ') $len = 1;
  979.                     if (isset($bindarr)) {    // is prepared sql, so no need to ocibindbyname again
  980.                         $bindarr[$k] = $v;
  981.                     } else {                 // dynamic sql, so rebind every time
  982.                         OCIBindByName($stmt,":$k",$inputarr[$k],$len);
  983.                     }
  984.                 }
  985.             }
  986.         }
  987.         
  988.         $this->_errorMsg = false;
  989.         $this->_errorCode = false;
  990.         if (OCIExecute($stmt,$this->_commit)) {
  991. //OCIInternalDebug(1);            
  992.             if (count($this -> _refLOBs) > 0) {
  993.         
  994.                 foreach ($this -> _refLOBs as $key => $value) {
  995.                     if ($this -> _refLOBs[$key]['TYPE'] == true) {
  996.                         $tmp = $this -> _refLOBs[$key]['LOB'] -> load();
  997.                         if ($this -> debug) {
  998.                             ADOConnection::outp("<b>OUT LOB</b>: LOB has been loaded. <br>");
  999.                         }
  1000.                         //$_GLOBALS[$this -> _refLOBs[$key]['VAR']] = $tmp;
  1001.                         $this -> _refLOBs[$key]['VAR'] = $tmp;
  1002.                     } else {
  1003.                         $this->_refLOBs[$key]['LOB']->save($this->_refLOBs[$key]['VAR']);
  1004.                         $this -> _refLOBs[$key]['LOB']->free();
  1005.                         unset($this -> _refLOBs[$key]);
  1006.                         if ($this->debug) {
  1007.                             ADOConnection::outp("<b>IN LOB</b>: LOB has been saved. <br>");
  1008.                         }
  1009.                     }                    
  1010.                 }
  1011.             }
  1012.         
  1013.             switch (@OCIStatementType($stmt)) {
  1014.                 case "SELECT":
  1015.                     return $stmt;
  1016.                 
  1017.                 case 'DECLARE':
  1018.                 case "BEGIN":
  1019.                     if (is_array($sql) && !empty($sql[4])) {
  1020.                         $cursor = $sql[4];
  1021.                         if (is_resource($cursor)) {
  1022.                             $ok = OCIExecute($cursor);    
  1023.                             return $cursor;
  1024.                         }
  1025.                         return $stmt;
  1026.                     } else {
  1027.                         if (is_resource($stmt)) {
  1028.                             OCIFreeStatement($stmt);
  1029.                             return true;
  1030.                         }
  1031.                         return $stmt;
  1032.                     }
  1033.                     break;
  1034.                 default :
  1035.                     // ociclose -- no because it could be used in a LOB?
  1036.                     return true;
  1037.             }
  1038.         }
  1039.         return false;
  1040.     }
  1041.     
  1042.     // returns true or false
  1043.     function _close()
  1044.     {
  1045.         if (!$this->_connectionID) return;
  1046.         
  1047.         if (!$this->autoCommit) OCIRollback($this->_connectionID);
  1048.         if (count($this->_refLOBs) > 0) {
  1049.             foreach ($this ->_refLOBs as $key => $value) {
  1050.                 $this->_refLOBs[$key]['LOB']->free();
  1051.                 unset($this->_refLOBs[$key]);
  1052.             }
  1053.         }
  1054.         OCILogoff($this->_connectionID);
  1055.         
  1056.         $this->_stmt = false;
  1057.         $this->_connectionID = false;
  1058.     }
  1059.     
  1060.     function MetaPrimaryKeys($table, $owner=false,$internalKey=false)
  1061.     {
  1062.         if ($internalKey) return array('ROWID');
  1063.         
  1064.     // tested with oracle 8.1.7
  1065.         $table = strtoupper($table);
  1066.         if ($owner) {
  1067.             $owner_clause = "AND ((a.OWNER = b.OWNER) AND (a.OWNER = UPPER('$owner')))";
  1068.             $ptab = 'ALL_';
  1069.         } else {
  1070.             $owner_clause = '';
  1071.             $ptab = 'USER_';
  1072.         }
  1073.         $sql = "
  1074. SELECT /*+ RULE */ distinct b.column_name
  1075.    FROM {$ptab}CONSTRAINTS a
  1076.       , {$ptab}CONS_COLUMNS b
  1077.   WHERE ( UPPER(b.table_name) = ('$table'))
  1078.     AND (UPPER(a.table_name) = ('$table') and a.constraint_type = 'P')
  1079.     $owner_clause
  1080.     AND (a.constraint_name = b.constraint_name)";
  1081.  
  1082.          $rs = $this->Execute($sql);
  1083.         if ($rs && !$rs->EOF) {
  1084.             $arr =& $rs->GetArray();
  1085.             $a = array();
  1086.             foreach($arr as $v) {
  1087.                 $a[] = reset($v);
  1088.             }
  1089.             return $a;
  1090.         }
  1091.         else return false;
  1092.     }
  1093.     
  1094.     // http://gis.mit.edu/classes/11.521/sqlnotes/referential_integrity.html
  1095.     function MetaForeignKeys($table, $owner=false)
  1096.     {
  1097.     global $ADODB_FETCH_MODE;
  1098.     
  1099.         $save = $ADODB_FETCH_MODE;
  1100.         $ADODB_FETCH_MODE = ADODB_FETCH_NUM;
  1101.         $table = $this->qstr(strtoupper($table));
  1102.         if (!$owner) {
  1103.             $owner = $this->user;
  1104.             $tabp = 'user_';
  1105.         } else
  1106.             $tabp = 'all_';
  1107.             
  1108.         $owner = ' and owner='.$this->qstr(strtoupper($owner));
  1109.         
  1110.         $sql = 
  1111. "select constraint_name,r_owner,r_constraint_name 
  1112.     from {$tabp}constraints
  1113.     where constraint_type = 'R' and table_name = $table $owner";
  1114.         
  1115.         $constraints =& $this->GetArray($sql);
  1116.         $arr = false;
  1117.         foreach($constraints as $constr) {
  1118.             $cons = $this->qstr($constr[0]);
  1119.             $rowner = $this->qstr($constr[1]);
  1120.             $rcons = $this->qstr($constr[2]);
  1121.             $cols = $this->GetArray("select column_name from {$tabp}cons_columns where constraint_name=$cons $owner order by position");
  1122.             $tabcol = $this->GetArray("select table_name,column_name from {$tabp}cons_columns where owner=$rowner and constraint_name=$rcons order by position");
  1123.             
  1124.             if ($cols && $tabcol) 
  1125.                 for ($i=0, $max=sizeof($cols); $i < $max; $i++) {
  1126.                     $arr[$tabcol[$i][0]] = $cols[$i][0].'='.$tabcol[$i][1];
  1127.                 }
  1128.         }
  1129.         $ADODB_FETCH_MODE = $save;
  1130.         
  1131.         return $arr;
  1132.     }
  1133.  
  1134.     
  1135.     function CharMax()
  1136.     {
  1137.         return 4000;
  1138.     }
  1139.     
  1140.     function TextMax()
  1141.     {
  1142.         return 4000;
  1143.     }
  1144.     
  1145.     /**
  1146.      * Quotes a string.
  1147.      * An example is  $db->qstr("Don't bother",magic_quotes_runtime());
  1148.      * 
  1149.      * @param s            the string to quote
  1150.      * @param [magic_quotes]    if $s is GET/POST var, set to get_magic_quotes_gpc().
  1151.      *                This undoes the stupidity of magic quotes for GPC.
  1152.      *
  1153.      * @return  quoted string to be sent back to database
  1154.      */
  1155.     function qstr($s,$magic_quotes=false)
  1156.     {    
  1157.     $nofixquotes=false;
  1158.     
  1159.         if ($this->noNullStrings && strlen($s)==0)$s = ' ';
  1160.         if (!$magic_quotes) {    
  1161.             if ($this->replaceQuote[0] == '\\'){
  1162.                 $s = str_replace('\\','\\\\',$s);
  1163.             }
  1164.             return  "'".str_replace("'",$this->replaceQuote,$s)."'";
  1165.         }
  1166.         
  1167.         // undo magic quotes for "
  1168.         $s = str_replace('\\"','"',$s);
  1169.         
  1170.         $s = str_replace('\\\\','\\',$s);
  1171.         return "'".str_replace("\\'",$this->replaceQuote,$s)."'";
  1172.         
  1173.     }
  1174.     
  1175. }
  1176.  
  1177. /*--------------------------------------------------------------------------------------
  1178.          Class Name: Recordset
  1179. --------------------------------------------------------------------------------------*/
  1180.  
  1181. class ADORecordset_oci8 extends ADORecordSet {
  1182.  
  1183.     var $databaseType = 'oci8';
  1184.     var $bind=false;
  1185.     var $_fieldobjs;
  1186.     
  1187.     //var $_arr = false;
  1188.         
  1189.     function ADORecordset_oci8($queryID,$mode=false)
  1190.     {
  1191.         if ($mode === false) { 
  1192.             global $ADODB_FETCH_MODE;
  1193.             $mode = $ADODB_FETCH_MODE;
  1194.         }
  1195.         switch ($mode)
  1196.         {
  1197.         case ADODB_FETCH_ASSOC:$this->fetchMode = OCI_ASSOC+OCI_RETURN_NULLS+OCI_RETURN_LOBS; break;
  1198.         case ADODB_FETCH_DEFAULT:
  1199.         case ADODB_FETCH_BOTH:$this->fetchMode = OCI_NUM+OCI_ASSOC+OCI_RETURN_NULLS+OCI_RETURN_LOBS; break;
  1200.         case ADODB_FETCH_NUM: 
  1201.         default:
  1202.         $this->fetchMode = OCI_NUM+OCI_RETURN_NULLS+OCI_RETURN_LOBS; break;
  1203.         }
  1204.         
  1205.         $this->adodbFetchMode = $mode;
  1206.         $this->_queryID = $queryID;
  1207.     }
  1208.  
  1209.  
  1210.     function Init()
  1211.     {
  1212.         if ($this->_inited) return;
  1213.         
  1214.         $this->_inited = true;
  1215.         if ($this->_queryID) {
  1216.             
  1217.             $this->_currentRow = 0;
  1218.             @$this->_initrs();
  1219.             $this->EOF = !$this->_fetch();
  1220.             
  1221.             /*
  1222.             // based on idea by Gaetano Giunta to detect unusual oracle errors
  1223.             // see http://phplens.com/lens/lensforum/msgs.php?id=6771
  1224.             $err = OCIError($this->_queryID);
  1225.             if ($err && $this->connection->debug) ADOConnection::outp($err);
  1226.             */
  1227.             
  1228.             if (!is_array($this->fields)) {
  1229.                 $this->_numOfRows = 0;
  1230.                 $this->fields = array();
  1231.             }
  1232.         } else {
  1233.             $this->fields = array();
  1234.             $this->_numOfRows = 0;
  1235.             $this->_numOfFields = 0;
  1236.             $this->EOF = true;
  1237.         }
  1238.     }
  1239.     
  1240.     function _initrs()
  1241.     {
  1242.         $this->_numOfRows = -1;
  1243.         $this->_numOfFields = OCInumcols($this->_queryID);
  1244.         if ($this->_numOfFields>0) {
  1245.             $this->_fieldobjs = array();
  1246.             $max = $this->_numOfFields;
  1247.             for ($i=0;$i<$max; $i++) $this->_fieldobjs[] = $this->_FetchField($i);
  1248.         }
  1249.     }
  1250.  
  1251.       /*        Returns: an object containing field information.
  1252.               Get column information in the Recordset object. fetchField() can be used in order to obtain information about
  1253.               fields in a certain query result. If the field offset isn't specified, the next field that wasn't yet retrieved by
  1254.               fetchField() is retrieved.        */
  1255.  
  1256.     function &_FetchField($fieldOffset = -1)
  1257.     {
  1258.         $fld = new ADOFieldObject;
  1259.         $fieldOffset += 1;
  1260.         $fld->name =OCIcolumnname($this->_queryID, $fieldOffset);
  1261.         $fld->type = OCIcolumntype($this->_queryID, $fieldOffset);
  1262.         $fld->max_length = OCIcolumnsize($this->_queryID, $fieldOffset);
  1263.          if ($fld->type == 'NUMBER') {
  1264.              $p = OCIColumnPrecision($this->_queryID, $fieldOffset);
  1265.             $sc = OCIColumnScale($this->_queryID, $fieldOffset);
  1266.             if ($p != 0 && $sc == 0) $fld->type = 'INT';
  1267.             //echo " $this->name ($p.$sc) ";
  1268.          }
  1269.         return $fld;
  1270.     }
  1271.     
  1272.     /* For some reason, OCIcolumnname fails when called after _initrs() so we cache it */
  1273.     function &FetchField($fieldOffset = -1)
  1274.     {
  1275.         return $this->_fieldobjs[$fieldOffset];
  1276.     }
  1277.     
  1278.     
  1279.     /*
  1280.     // 10% speedup to move MoveNext to child class
  1281.     function _MoveNext() 
  1282.     {
  1283.     //global $ADODB_EXTENSION;if ($ADODB_EXTENSION) return @adodb_movenext($this);
  1284.         
  1285.         if ($this->EOF) return false;
  1286.         
  1287.         $this->_currentRow++;
  1288.         if(@OCIfetchinto($this->_queryID,$this->fields,$this->fetchMode))
  1289.             return true;
  1290.         $this->EOF = true;
  1291.         
  1292.         return false;
  1293.     }    */
  1294.     
  1295.     
  1296.     function MoveNext()
  1297.     {
  1298.         if (@OCIfetchinto($this->_queryID,$this->fields,$this->fetchMode)) {
  1299.             $this->_currentRow += 1;
  1300.             return true;
  1301.         }
  1302.         if (!$this->EOF) {
  1303.             $this->_currentRow += 1;
  1304.             $this->EOF = true;
  1305.         }
  1306.         return false;
  1307.     }
  1308.     
  1309.     
  1310.     /* Optimize SelectLimit() by using OCIFetch() instead of OCIFetchInto() */
  1311.     function &GetArrayLimit($nrows,$offset=-1) 
  1312.     {
  1313.         if ($offset <= 0) {
  1314.             $arr =& $this->GetArray($nrows);
  1315.             return $arr;
  1316.         }
  1317.         for ($i=1; $i < $offset; $i++) 
  1318.             if (!@OCIFetch($this->_queryID)) return array();
  1319.             
  1320.         if (!@OCIfetchinto($this->_queryID,$this->fields,$this->fetchMode)) return array();
  1321.         $results = array();
  1322.         $cnt = 0;
  1323.         while (!$this->EOF && $nrows != $cnt) {
  1324.             $results[$cnt++] = $this->fields;
  1325.             $this->MoveNext();
  1326.         }
  1327.         
  1328.         return $results;
  1329.     }
  1330.  
  1331.     
  1332.     /* Use associative array to get fields array */
  1333.     function Fields($colname)
  1334.     {
  1335.         if (!$this->bind) {
  1336.             $this->bind = array();
  1337.             for ($i=0; $i < $this->_numOfFields; $i++) {
  1338.                 $o = $this->FetchField($i);
  1339.                 $this->bind[strtoupper($o->name)] = $i;
  1340.             }
  1341.         }
  1342.         
  1343.          return $this->fields[$this->bind[strtoupper($colname)]];
  1344.     }
  1345.     
  1346.  
  1347.  
  1348.     function _seek($row)
  1349.     {
  1350.         return false;
  1351.     }
  1352.  
  1353.     function _fetch() 
  1354.     {
  1355.         return @OCIfetchinto($this->_queryID,$this->fields,$this->fetchMode);
  1356.     }
  1357.  
  1358.     /*        close() only needs to be called if you are worried about using too much memory while your script
  1359.             is running. All associated result memory for the specified result identifier will automatically be freed.        */
  1360.  
  1361.     function _close() 
  1362.     {
  1363.         if ($this->connection->_stmt === $this->_queryID) $this->connection->_stmt = false;
  1364.         if (!empty($this->_refcursor)) {
  1365.             OCIFreeCursor($this->_refcursor);
  1366.             $this->_refcursor = false;
  1367.         }
  1368.         @OCIFreeStatement($this->_queryID);
  1369.          $this->_queryID = false;
  1370.         
  1371.     }
  1372.  
  1373.     function MetaType($t,$len=-1)
  1374.     {
  1375.         if (is_object($t)) {
  1376.             $fieldobj = $t;
  1377.             $t = $fieldobj->type;
  1378.             $len = $fieldobj->max_length;
  1379.         }
  1380.         switch (strtoupper($t)) {
  1381.          case 'VARCHAR':
  1382.          case 'VARCHAR2':
  1383.         case 'CHAR':
  1384.         case 'VARBINARY':
  1385.         case 'BINARY':
  1386.         case 'NCHAR':
  1387.         case 'NVARCHAR':
  1388.         case 'NVARCHAR2':
  1389.                  if (isset($this) && $len <= $this->blobSize) return 'C';
  1390.         
  1391.         case 'NCLOB':
  1392.         case 'LONG':
  1393.         case 'LONG VARCHAR':
  1394.         case 'CLOB':
  1395.         return 'X';
  1396.         
  1397.         case 'LONG RAW':
  1398.         case 'LONG VARBINARY':
  1399.         case 'BLOB':
  1400.             return 'B';
  1401.         
  1402.         case 'DATE': 
  1403.             return  ($this->connection->datetime) ? 'T' : 'D';
  1404.         
  1405.         
  1406.         case 'TIMESTAMP': return 'T';
  1407.         
  1408.         case 'INT': 
  1409.         case 'SMALLINT':
  1410.         case 'INTEGER': 
  1411.             return 'I';
  1412.             
  1413.         default: return 'N';
  1414.         }
  1415.     }
  1416. }
  1417.  
  1418. class ADORecordSet_ext_oci8 extends ADORecordSet_oci8 {    
  1419.     function ADORecordSet_ext_oci8($queryID,$mode=false) 
  1420.     {
  1421.         if ($mode === false) { 
  1422.             global $ADODB_FETCH_MODE;
  1423.             $mode = $ADODB_FETCH_MODE;
  1424.         }
  1425.         switch ($mode)
  1426.         {
  1427.         case ADODB_FETCH_ASSOC:$this->fetchMode = OCI_ASSOC+OCI_RETURN_NULLS+OCI_RETURN_LOBS; break;
  1428.         case ADODB_FETCH_DEFAULT:
  1429.         case ADODB_FETCH_BOTH:$this->fetchMode = OCI_NUM+OCI_ASSOC+OCI_RETURN_NULLS+OCI_RETURN_LOBS; break;
  1430.         case ADODB_FETCH_NUM: 
  1431.         default: $this->fetchMode = OCI_NUM+OCI_RETURN_NULLS+OCI_RETURN_LOBS; break;
  1432.         }
  1433.         $this->adodbFetchMode = $mode;
  1434.         $this->_queryID = $queryID;
  1435.     }
  1436.     
  1437.     function MoveNext()
  1438.     {
  1439.         return adodb_movenext($this);
  1440.     }
  1441. }
  1442. ?>